home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / disk / upcopy60.zip / UPCOPY.DOC < prev    next >
Text File  |  1996-08-21  |  17KB  |  361 lines
  1.                ╔════════════════════════════════════════╗
  2.                ║                UPCOPY                  ║
  3.                ║   Copyright (c) 1994-96 L.I.Williams   ║
  4.                ║          All rights reserved           ║
  5.                ║   Issue 6.0             Date: 22Aug96  ║
  6.                ╚════════════════════════════════════════╝
  7.  
  8.      UPCOPY is a directory synchronizer - it copies files one or both both
  9.      ways as necessary to make directories identical (whole trees if you
  10.      register). It picks out new or updated files and can choose the right
  11.      copy direction for you, that makes it fast. UPCOPY can erase files
  12.      and show file information and comparisons. It's useful across a
  13.      network to synchronize PC's.
  14.  
  15.      UPCOPY has a menu mode well suited to Windows. See UPCWIN.DOC for
  16.      Windows installation instructions. But, as a simple DOS command:
  17.  
  18.      Usage:    UPCOPY path1 [path2]      (e.g. UPCOPY a:)
  19.  
  20.      The parameters are:
  21.  
  22.        path1         Specifies the first directory or file(s) to be
  23.                      handled.
  24.        path2         Specifies the other directory and/or filename(s).
  25.        /B            Run in DOS batch or command mode
  26.        /C            Only processes common files and ignores new files.
  27.        /CD           Only processes common directories and ignores new
  28.                      directories
  29.        /D            Differencing. Also asks if you want to compare files
  30.                      when they are different.
  31.        /E            New files not copied can be erased.
  32.        /EC           Suppress copying and erase duplicate copies. With
  33.                      prompts you can choose which duplicate is erased,
  34.                      otherwise it's the target.
  35.        /F            Forward only. Only copies or asks to copy from path1
  36.                      (source) to path2 (target). Path1 is not altered.
  37.        /I            Information only. Compares directories without
  38.                      copying.
  39.        /M            Mirror copies system and hidden files, and those with
  40.                      changed attributes or size, and the same time.
  41.        /N            Processes new files and ignores common files
  42.        /O            Can overwrite new with old as well.
  43.        /Q            Quick and quiet. This suppresses a lot of information
  44.                      and does no checks after copying.
  45.        /R            Can overwrite or erase read only files.
  46.        /S            Processes subdirectories (keyfile enabled)
  47.        /W            Run in windowed menu mode (default for no parameters)
  48.        /Y            Automatic mode. No prompts.
  49.  
  50.      You can put the options where you like, and stop UPCOPY any time with
  51.      CTRL+Break or CTRL+C. A '+' means copy the other path. The minimal
  52.      list of files installed is:
  53.  
  54.             UPCOPY.EXE   - the program
  55.             UPCOPY.DOC   - this documentation
  56.             UPCOPY.HLP   - help file for windowed mode
  57.             UPCREG.DOC   - Registration information
  58.  
  59.  
  60.                                   Page 1 of 6
  61.      These are optional to users:
  62.  
  63.             UPCFREE.DOC- Application for free evaluation keyfile
  64.             UPCWIN.DOC - Windows installation instructions for UPCOPY as a
  65.                          non-Windows application
  66.             UPCOPY.REC - Windows recorder macro for installing UPCOPY
  67.             UPCOPY.PIF - Windows Program Information File
  68.             UPCOPY.ICO - Windows icon
  69.             UPCEG.BAT  - batch example creating temporary directories
  70.             UPCSYNC.BAT- directory synchronization leaving out certain
  71.                          files
  72.             DC.BAT     - handy directory-compare batch file using UPCOPY
  73.  
  74.      These are not automatically copied from the disk or source directory;
  75.      some may not concern you, 'packaging' etc:
  76.  
  77.             FILE_ID.DIZ  - short description for distributors
  78.             VENDOR.DOC   - information for distributors
  79.             VENDINFO.DIZ - machine readable info for distributors
  80.             HISTORY.DOC  - issue notes showing changes over time
  81.             README.BAT   - a short introduction
  82.             INSTALL.BAT  - copies above files to a suitable directory
  83.             UMAIN.C00    - one of the source modules,included for interest
  84.  
  85.      Examples of Use
  86.      ───────────────
  87.      *   Keeps local and server versions of directories in
  88.          synchronisation, minimising network traffic.
  89.  
  90.      *   Keeps directories aligned on a home PC, and one at work, using a
  91.          transfer disk.
  92.  
  93.      *   Copies the latest files in both directions to a master disk (or
  94.          network directory), which is shared by a group working together
  95.  
  96.      *   Keeps straightforward backups (or many rotated backups) of a
  97.          directory - no need to worry about file attributes or incremental
  98.          and absolute backups.
  99.  
  100.      *   Synchronize two directories and then remove the duplicate -
  101.          nothing gets lost.
  102.  
  103.      UPCOPY is ideal for use over a network, with the Interlnk connection
  104.      system, removable hard disks, and parallel port hard disks.
  105.  
  106.      UPCOPY mostly uses the date and time stamp of the files. It doesn't
  107.      use the DOS archive attribute, and it doesn't check the contents of
  108.      the files - that makes it fast.
  109.  
  110.      Example
  111.      ───────
  112.      Suppose two directories on disk C \temp1 \temp2 contain files as
  113.      follows:UMAIN.C00 is the same in both, UUTL.C00 is newer in \temp2,
  114.      UGLOB.H00 is newer in \temp1, UEXTERN.H00 exists only in \temp1 and
  115.      UDEF.H00 exists only in \temp2.
  116.  
  117.  
  118.  
  119.  
  120.                                   Page 2 of 6
  121.      The command 'UPCOPY \temp1 \temp2 /y' produces this result:
  122.      UPCOPY 6.0, Shareware Version, (c) 1994-96 L.I.Williams.
  123.          C:\TEMP1\*.*                    ..   C:\TEMP2\*.*
  124.      UMAIN   C00   12k 14Jan96 16:58  ==  UMAIN   C00   12k 14Jan96 16:58
  125.      UUTL    C00   14k 15Jan96 11:51  <=  UUTL    C00   14k 18Jan96 16:08
  126.      ... file C:\TEMP2\UUTL.C00 copied to C:\TEMP1\UUTL.C00
  127.      UEXTERN H00  4561 17Jan96 16:39  =>  ... New file, no version here
  128.      ... file C:\TEMP1\UEXTERN.H00 copied to C:\TEMP2\UEXTERN.H00
  129.      UGLOB   H00  8401 18Jan96 16:07  =>  UGLOB   H00  8401 18Jan96 14:50
  130.      ... file C:\TEMP1\UGLOB.H00 copied to C:\TEMP2\UGLOB.H00
  131.      ... New file, no version here    <=  UDEF    H00  3431 17Jan96 16:49
  132.      ... file C:\TEMP2\UDEF.H00 copied to C:\TEMP1\UDEF.H00
  133.      Checking result ...
  134.      File(s) specified are now the same
  135.  
  136.      Both directories are now identical and up-to-date. Just to confirm
  137.      this if we now type 'UPCOPY \temp1 \temp2 /i' we get:
  138.  
  139.      UPCOPY 6.0, Shareware Version, (c) 1994-96 L.I.Williams.
  140.          C:\TEMP1\*.*                    ..   C:\TEMP2\*.*
  141.      UMAIN   C00   12k 14Jan96 16:58  ==  UMAIN   C00   12k 14Jan96 16:58
  142.      UUTL    C00   14k 18Jan96 16:08  ==  UUTL    C00   14k 18Jan96 16:08
  143.      UDEF    H00  3431 17Jan96 16:49  ==  UDEF    H00  3431 17Jan96 16:49
  144.      UEXTERN H00  4561 17Jan96 16:39  ==  UEXTERN H00  4561 17Jan96 16:39
  145.      UGLOB   H00  8401 18Jan96 16:07  ==  UGLOB   H00  8401 18Jan96 16:07
  146.      File(s) specified are the same
  147.  
  148.      Restrictions
  149.      ────────────
  150.      UPCOPY cannot rename files as it copies and a hard disk is desirable.
  151.      Specifically, UPCOPY will not do file compares and ignores /D if
  152.      there is no access to the DOS 'FC' program. Also help is restricted
  153.      if UPCOPY.HLP, the DOS 'MORE' program, or this file UPCOPY.DOC is not
  154.      in the current directory (or one specified by the PATH variable). Or
  155.      to put it another way UPCOPY will still work (limping a bit!), as
  156.      just UPCOPY.EXE on a boot disk.
  157.  
  158.      Hints
  159.      ─────
  160.      You need to keep the clock on your PC about right, especially if you
  161.      use UPCOPY to move files between PC's. If you put the PC clock BACK
  162.      an hour during the working day you can make a new file version look
  163.      old, so it's best to change the clock first thing in the morning, and
  164.      keep all PC's on the same time.
  165.  
  166.      /f/y/o/e/q is a handy combination for fas